##############################################################################
###+------------+#############################################################
#+-| CAPFIRST() |------------------------------------------+##################
#| +------------+ Makes first letter of any word uppercase |##################
#+---------------------------------------------------------+##################
##############################################################################
##############################################################################
#+--| Summary |----------------+##############################################
#|     #INCLUDE string.hdr     |################################################
#+-----------------------------+##############################################
##############################################################################
##############################################################################
#+--| Syntax |------------------------------+#################################
#|     FUNCTION CHAR capfirst PROTOTYPE     |#################################
#|      PARAMETERS CONST CHAR string        |#################################
#+------------------------------------------+#################################
##############################################################################
##############################################################################
#########+---| Description |----------------------------------------+#########
#########| The capfirst() function returns a character string in    |#########
#########| which the first character of any substring within string |#########
#########| is converted to uppercase while the remaining characters |#########
#########| are converted to lowercase.                              |#########
#########+----------------------------------------------------------+#########
##############################################################################
##############################################################################
#########+--| Example 1 |-------------------------------------------+#########
#########|                                                          |#########
#########| ? capsfirst("adam schelin")                              |#########
#########|                                                          |#########
#########| Output:                                                  |#########
#########| Adam Schelin                                             |#########
#########+----------------------------------------------------------+#########
##############################################################################
##############################################################################
#########+--| Example 2 |-------------------------------------------+#########
#########|                                                          |#########
#########| ? capsfirst("AFFORDABLE STEREO")                         |#########
#########|                                                          |#########
#########| Output:                                                  |#########
#########| Affordable Stereo                                        |#########
#########+----------------------------------------------------------+#########
##############################################################################